home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 July / Amiga Games 1996 #7.iso / userbox / publicdomain / amigabase / data / english / scheduler.readme < prev    next >
Text File  |  1994-10-09  |  6KB  |  113 lines
  1. [Note from Steffen Gutmann: This project has been created
  2. by Eyal Teler. Thanks Eyal. I have made some minor changes
  3. to the project and this readme file.]
  4.  
  5. Scheduler - an appointment book
  6. ===============================
  7.  
  8.   This is an example of what can be achieved with Amigabase with some work.
  9. Scheduler was written on Workbench 1.3. Use of ARexx might have made it
  10. better. Filtering from a program could have made it simpler. As it is,
  11. Scheduler is quite powerful, but sometimes a bit slow.
  12.   Scheduler was written in two days. There are many ways to enhance it,
  13. and make it into a truely useful application (for example by adding
  14. monthly and daily views, adding an address book, etc.).
  15.   Scheduler is not intended to show good programming style, and indeed
  16. it could be made clearer. On the other hand, it is intended to show (some
  17. of) the power of AmigaBase.
  18.  
  19. What is Scheduler:
  20. -----------------
  21.   Scheduler allows you to keep track of your appointments, much like the
  22. 'Address' project. But in addition the keeping the list of appointments,
  23. Scheduler also allows viewing a yearly calendar, marked according to the
  24. appointments, and selecting an appointment from this calendar. Scheduler
  25. also allows simple entry of common names and other values, and has
  26. automatic checking for overlapping appointments.
  27.  
  28. Starting:
  29. ---------
  30.   There are two ways to create an appointment book. Either take a full
  31. one (such as the example one), and use 'Init' (a button at the top right
  32. of the form), or load an empty one (using 'Open Structure') and add
  33. a new global record (in the usual way).
  34.  
  35. Managing appointments:
  36. ----------------------
  37.   To create a new appointment, just create a new 'Appoint' record, and
  38. enter the date, time, and length of the appointment (length is a time
  39. field). When the length of the appointment is entered, Scheduler will
  40. search for other appointments in the same time span. If there is such
  41. an appointment, Scheduler will issue a warning. It's possible to ignore
  42. the warning, and have two appointments at the same time. Appointments
  43. with their length field empty don't count for this check. In general, the
  44. offending appointment will be one immediately preceding of succeding
  45. the current one, due to the ordering, but in any case it's possible to
  46. use the 'Swap' button (above the Appoint record).
  47.   The other input fields in the record are self explanatory. There are
  48. also three buttons, which hold the name of 'Length', 'Who' and 'Where'
  49. fields. When activating these, a list of default values will be
  50. presented, and you can select one by double-clicking. The default values
  51. are taken from the 'Defaults' window, whose button is above the Appoint
  52. record. This window holds three memo fields. Each line in these fields
  53. is one default value.
  54.   It's possible to move between appointments normally, and also to
  55. switch back and forth between two datasets. By pressing the 'Remember'
  56. button, above the Appoint record, Scheduler will remember the current
  57. record number (it's also possible to enter it directly into the field
  58. near the button). It's possible to later go to this record (and back)
  59. by using the 'Swap' button. [ This isn't a really useful feature. ]
  60. Note that if a record is added ir changed, the number may no longer
  61. refer to the same record.
  62.  
  63. The calendar:
  64. -------------
  65.   The yearly calendar, available in the 'Year' window, shows a full
  66. year, with each appointment shown as a star on the corrsponding day in
  67. the calendar (even if there's more than one appointment per day, only
  68. one star is displayed).
  69.   The field 'Year' at the top left of the form contains the year to be
  70. displayed. If this number is changed, the calendar will change to display
  71. the new year. It's also possible to move one year forward of backward, by
  72. using the arrow buttons near the 'Year' field.
  73.   Changes to the appointments will not appear immediately in the calendar.
  74. To view the changes it's possible to use the 'Update' button. Changing
  75. the year in one of the above ways will always display an updated calendar,
  76. as will changing the display mode (see below).
  77.   There are two display modes to the calendar. 'Day of month' displays
  78. the days of each month from the left of the field. 'Weekday' displays
  79. the days according to the day of the week. If first day of the month will
  80. be placed according to the corresponding day of the week. The area before
  81. the first day of the month is filled by '#' characters in this mode.
  82.  
  83.   Another feature of the calendar is the ability to select an appointment.
  84. This is done using the month buttons at the left of the window. When
  85. activated, a month button will display all the appointments of the month
  86. (if there are any). The record number is displayed, as well as date, time
  87. and who the meeting is with. Selecting one of the displayed appointments
  88. will bring the appointment window to the front, with the selected
  89. appointment displayed.
  90.  
  91. Notes:
  92. ------
  93.   It's of course possible to filter the records, in order to find meetings
  94. with a specific person, for example. This doesn't appear to affect the
  95. calendar display.
  96.  
  97.   The appointment datasets are ordered by Date, Time and length. Some
  98. programs count on the datasets being ordered by Date or Date/Time.
  99.   The fields names of the Date and Time fields are Tim and Dat (because
  100. the words Date and Time are reserved by AmigaBase).
  101.   It's possible to have more than one appointment book in the same project,
  102. by creating several top level records. This might cause a wrong message
  103. to appear (asking to erase the records of the current project), and it
  104. should be cancelled. Having more than one appointment book in this way
  105. is not really supported, but it should work.
  106.   It's also possible to have more than one set of default values.
  107.   I see no reason to use either multiple appointment books or multiple
  108. defaults, but they are there if you want them.
  109.   There is one and only one calendar dataset. It's created on initialisation,
  110. and is updated by the function _Recalc. It's impossible to add or delete
  111. calendar datasets.
  112.  
  113.